home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / sphmode.z / sphmode
Text File  |  1998-10-20  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSPPPPHHHHMMMMOOOODDDDEEEE((((3333LLLL))))                                                        SSSSPPPPHHHHMMMMOOOODDDDEEEE((((3333LLLL))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssspppphhhhmmmmooooddddeeee - set sphere attributes
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ggggllll////sssspppphhhheeeerrrreeee....hhhh>>>>
  13.  
  14.      iiiinnnntttt sssspppphhhhmmmmooooddddeeee((((aaaattttttttrrrriiiibbbbuuuutttteeee,,,, vvvvaaaalllluuuueeee))))
  15.      iiiinnnntttt aaaattttttttrrrriiiibbbbuuuutttteeee,,,, vvvvaaaalllluuuueeee;;;;
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _a_t_t_r_i_b_u_t_e
  19.             the sphere attribute to set
  20.  
  21.      _v_a_l_u_e  the value to which the attribute is to be set
  22.  
  23. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  24.      Returns -1 if an invalid attribute or value is specified, 0 otherwise.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      sssspppphhhhmmmmooooddddeeee is used to specify the attributes of a sphere.
  28.  
  29.      The sphere attributes and valid settings are as follows:
  30.  
  31.      SSSSPPPPHHHH____TTTTEEEESSSSSSSS
  32.           selects the type of sphere tesselation.  Valid settings for
  33.           tesselation are: SSSSPPPPHHHH____OOOOCCCCTTTT, SSSSPPPPHHHH____IIIICCCCOOOOSSSS, SSSSPPPPHHHH____BBBBAAAARRRRYYYY, SSSSPPPPHHHH____CCCCUUUUBBBBEEEE, and
  34.           SSSSPPPPHHHH____BBBBIIIILLLLIIIINNNN. These constants correspond to algorithms that tesselate a
  35.           sphere into polygons based on the following types of tesselation:
  36.           octahedral, icosahedral, barycentric, cubic, and bilinear
  37.           tesselation.  The octahedral, icosahedral, and cubic methods
  38.           tesselate by subdividing the original faces of the base form.  The
  39.           barycentric method guarantees that all of the triangles have equal
  40.           area and has the same number of triangles as the octahedral
  41.           tesselation.  The  bilinear tesselation is the traditional
  42.           longitude-latitude method.  The default tesselation is SSSSPPPPHHHH____OOOOCCCCTTTT.
  43.  
  44.      SSSSPPPPHHHH____DDDDEEEEPPPPTTTTHHHH
  45.           sets depth of sphere tesselation. The number of polygons in a sphere
  46.           is a function of the tesselation type, depth, and primitive used.
  47.           Higher depth values result in more polygons, and hence a smoother
  48.           looking sphere that takes longer to draw.  Valid settings for sphere
  49.           depth are any value from 1 to SSSSPPPPHHHH____MMMMAAAAXXXXDDDDEEEEPPPPTTTTHHHH, inclusive.  The default
  50.           sphere depth is 5.
  51.  
  52.      SSSSPPPPHHHH____PPPPRRRRIIIIMMMM
  53.           selects the GL drawing primitive.  Valid settings for sphere
  54.           primitive are: SSSSPPPPHHHH____PPPPOOOOLLLLYYYY, SSSSPPPPHHHH____MMMMEEEESSSSHHHH, SSSSPPPPHHHH____LLLLIIIINNNNEEEE, and SSSSPPPPHHHH____PPPPOOOOIIIINNNNTTTT.  When
  55.           the primitive attribute is set to SSSSPPPPHHHH____PPPPOOOOLLLLYYYY, independent triangles or
  56.           quads are drawn, depending on the sphere tesselation type.  When
  57.           using SSSSPPPPHHHH____MMMMEEEESSSSHHHH, tmeshes or qstrips are used.  The default value for
  58.           the sphere primitive is SSSSPPPPHHHH____MMMMEEEESSSSHHHH.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSPPPPHHHHMMMMOOOODDDDEEEE((((3333LLLL))))                                                        SSSSPPPPHHHHMMMMOOOODDDDEEEE((((3333LLLL))))
  71.  
  72.  
  73.  
  74.      SSSSPPPPHHHH____HHHHEEEEMMMMIIII
  75.           toggles the hemisphere attribute.  When TRUE, less than the entire
  76.           sphere may be drawn, but all of the non-negative Z portion of the
  77.           sphere from its canonical orientation will be drawn. Use of this
  78.           attribute can improve performance when using the SSSSPPPPHHHH____OOOORRRRIIIIEEEENNNNTTTT
  79.           attribute.  The default value is FALSE, meaning that full spheres
  80.           are drawn.
  81.  
  82.      SSSSPPPPHHHH____OOOORRRRIIIIEEEENNNNTTTT
  83.           to toggle the fixed-orientation attribute.  When TRUE, spheres will
  84.           be displayed in a fixed orientation. This means that when viewing
  85.           rotations are done, the center of a sphere is transformed to its
  86.           correct position, and the sphere surface is drawn in a fixed
  87.           orientation. The default orientation is the canonical orientation
  88.           unless specified by user with the sssspppphhhhrrrroooottttmmmmaaaattttrrrriiiixxxx cmd.  Use of this
  89.           attribute can reduce some lighting artifacts.  When the value of
  90.           SPH_ORIENT is TRUE, the Sphere Library assumes uniform scaling.
  91.           When doing non-uniform scaling in viewing transformations the
  92.           results are undefined.  The default value is FALSE so that spheres
  93.           can be manipulated freely by all matrix operations.
  94.  
  95. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  96.      libsphere, sphdraw, sphfree, sphgnpolys, sphobj, sphrotmatrix
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.